home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / LYME110.ZIP / LYME.DOC < prev    next >
Encoding:
Text File  |  1996-03-23  |  10.5 KB  |  262 lines
  1. \
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                   LYME
  9.                                     
  10.                    TIC processor for RemoteAccess 2.50
  11.                                     
  12.                                Version 1.1
  13.                           Released 15 Jan 1996
  14.                                     
  15.                              By Pab Sungenis
  16.                     Copr. 1995, 1996 EMPIRE Software
  17.                                     
  18.                        Another Shareware Offering
  19.                                     
  20.  
  21.  
  22.                                     
  23.                                     
  24.                                     
  25.                               ------------
  26.                               INTRODUCTION
  27.                               ------------
  28.                                     
  29.      LYME was written to implement a number of features I, as a
  30. SysOp, wanted to see in a TIC processor, and to correct a number
  31. of problems that existed in the processor I was using before.  In
  32. addition to the standard features found in most processors, Lyme
  33. offers a number of 'extras' including....
  34.  
  35.      * Support for ALLTICS files
  36.      * Built-in 'Ticket' message generation
  37.      * Selective killing of unwanted file areas
  38.      * Easy set-up and operation
  39.      * Ability to use LDESC long description fields in TICs
  40.      * Support for .RAR file compression
  41.      * Up to 1,024 file areas in a single config file
  42.  
  43.      Plus, Lyme is fully integrated with RA 2.50, allowing you to
  44. make changes to your RA file areas, and have those changes
  45. immediately used by your TIC processor.
  46.      Lyme is easy to install, easy to set up, and even easier to
  47. use.  If you've been using another processor, give it a try.  I
  48. think you won't be disappointed.
  49.  
  50.  
  51.                                   -----
  52.                                   SETUP
  53.                                   -----
  54.                                     
  55.      Extract LYME.EXE to your RA directory, or another directory
  56. of your choice.  A sample configuration file, with comments, is
  57. also included in the archive.
  58.      Lyme uses a simple text file for its configuration.  The
  59. first non-comment line of the file (in other words, not beginning
  60. with a semicolon) must be the path for your files and TICs.  All
  61. other lines of the file may be either commands or file area
  62. definitions.
  63.  
  64.      * COMMANDS: All command lines begin with an exclamation
  65. point.  Commands supported by Lyme are:
  66.  
  67.      !DIZ ON|OFF
  68.  
  69.           This command allows you to specify whether
  70.           FILE_ID.DIZ files will be imported into your
  71.           file database.  Lyme will extract FILE_ID.DIZ
  72.           from files compressed using PAK, ARC, LZH,
  73.           ZIP, ARJ, and RAR compression.  (Note: You
  74.           must have the appropriate utilities --
  75.           PKUNZIP.EXE, LHA.EXE, etc. -- in your search
  76.           path.  If you do not, Lyme will not be able
  77.           to use FILE_ID.DIZ from files of that type.)
  78.           The default is ON.
  79.  
  80.      !LDESC ON|OFF
  81.  
  82.           This determines whether or not LDESC long
  83.           description lines will be imported into your
  84.           database.  Some FDN's use these lines to
  85.           provide long descriptions for uncompressed
  86.           files (such as PCBoard PPE's) and self-
  87.           extracting EXE's.  The default is ON.
  88.  
  89.           Note: if you have both !DIZ ON and !LDESC ON
  90.           in your configuration file, the FILE_ID.DIZ
  91.           will take precedence over any LDESC lines.
  92.  
  93.      !TICKET mbase name
  94.  
  95.           If you include this command in your config
  96.           file, Lyme will generate a "Ticket" message
  97.           in the specified message base, addressed to
  98.           the specified name.
  99.  
  100.           The message will list all files which were
  101.           imported, the file area they came from, and a
  102.           short description of the file.  This allows
  103.           you to see, at a glance, the files that have
  104.           arrived on a given day.
  105.  
  106.      !ORPHAN KEEP|KILL
  107.  
  108.           This controls Lyme's treatment of orphaned
  109.           TIC files (i.e.: TICs which arrive without
  110.           their matching files).  If you choose KILL,
  111.           the orphaned TIC files will be deleted.  The
  112.           default is KEEP.
  113.  
  114.      !UNKNOWN KEEP|KILL
  115.  
  116.           This controls Lyme's treatment of TICs which
  117.           belong to file areas not specified in your
  118.           configuration file.  If you choose KILL, the
  119.           TIC and file will be deleted.  The default is
  120.           KEEP.
  121.  
  122.      !ALLTICS filespec
  123.  
  124.           This allows you to specify a filespec to search
  125.           for which may contain a number of .TIC files
  126.           compressed into one.  This command allows you
  127.           to change the default filespec (ALLTICS.*) to
  128.           another if your provider uses a different file-
  129.           name.  (For example, the TVLIST distribution
  130.           system uses TVLISTTK.ARC).
  131.  
  132.      All other non-comment lines are assumed to be file area
  133. definitions.  The format for these lines is as follows:
  134.  
  135.      areaname areanum|KILL
  136.  
  137.      The 'areaname' is the name of the file area as specified in
  138. the TIC files.  (Wildcards are allowed.)  'Areanum' is the number
  139. of the file area (as defined in your RA configuration) the file
  140. should be imported to.
  141.      You may also specify 'KILL' as your import area.  Any files
  142. arriving from that area will be deleted.  This feature is most
  143. useful for users of satellite delivery systems (such as Planet
  144. Connect) where you cannot unlink individual areas.
  145.  
  146.      Sample area definitions:
  147.  
  148.      ;Import SDN text to area 37
  149.      1-TEXT 37             
  150.      ;Import RA Distribution to area 1
  151.      RAD* 1
  152.      ;Kill any Amiga files
  153.      ADS* KILL
  154.  
  155.  
  156.                                ----------
  157.                                USING LYME
  158.                                ----------
  159.                                     
  160.      To run Lyme, simply type:
  161.  
  162.           LYME [filename]
  163.  
  164.      where 'filename' is the name of the configuration file to
  165. use.  If none is specified, Lyme will use LYME.CFG for its
  166. configuration.
  167.      Lyme will first read your CONFIG.RA, MESSAGES.RA and
  168. FILES.RA files to get its bearings.  Next, Lyme will unpack any
  169. ALLTICS files found in your TIC directory.
  170.      Each TIC will then be read, and Lyme will check for the
  171. appropriate file.  If the file is not found, the TIC is an orphan
  172. and will be treated as such.  If the file exists, Lyme next
  173. checks the area it arrived in against the areas in your
  174. configuration file.  If it is in an unknown area, it will either
  175. be deleted or ignored depending upon your use of the !UNKNOWN
  176. command.  If the file is compressed and you have not used the
  177. !DIZ OFF command, Lyme will check for and extract the FILE_ID.DIZ
  178. from it.
  179.      Next, Lyme will copy the file to the proper directory and
  180. create an entry in that area's database for the file.  If the
  181. file already exists in that area, or if a file matching the TIC's
  182. 'Replace' field (if any) exists, Lyme will overwrite the entry
  183. for that file with the new one.
  184.      After all TICs have been processed, Lyme will close its log
  185. file (LYME.LOG) and, if you have used the !TICKET command,
  186. generate a 'ticket' message.
  187.  
  188.  
  189.                      ------------------------------
  190.                      USING LYME WITH PLANET CONNECT
  191.                      ------------------------------
  192.                                     
  193.      The advent of Fidonet delivery by satellite has meant many
  194. changes in the way things used to work.  Many 'traditional'
  195. methods (including RAID messages and individual TIC files) are
  196. either impossible or too inefficient to be used over the
  197. satellite.
  198.      Many of the new features in Lyme were designed to work with
  199. standards set by Planet Connect and other satellite services. 
  200. This section will help you configure Lyme to use these features
  201. and work best with these services.
  202.  
  203.      * ALLTICS.*  --  Lyme will automatically decompress and use
  204. any ALLTICS format files found in your TIC path.  There is no
  205. need to process these files manually; remove any lines from batch
  206. files that decompress ALLTICS.
  207.  
  208.      * UNKNOWN AREAS -- Most services will add file areas
  209. regularly, and you may wake some morning to find a number of
  210. files you hadn't expected are sitting on your drive.
  211.      I suggest that you do not delete unknown areas
  212. automatically, but instead use KILL options to delete file areas
  213. you know you do not want.  You can then check these new areas, to
  214. see if you want to import them or not.
  215.  
  216.      * ORPHANS  --  I strongly advise you to not delete orphaned
  217. TICs.  Since the ALLTICS method means that all TICs arrive at
  218. once instead of in matched pairs with their accompanying files,
  219. you may still be receiving the actual files when your BBS starts
  220. tossing.  You may also have a file trashed on the first pass but
  221. have it received correctly later.  Instead you should
  222. occasionally manually erase leftover orphans.
  223.  
  224.      Lyme's defaults are configured to work best with satellite
  225. delivery.  For optimum use, do not override them with !ORPHAN or
  226. !UNKNOWN commands.
  227.  
  228.      -- USING LYME WITH PC AND TVAGENT
  229.  
  230.      If you want to import the TVLIST files into your BBS through
  231. Planet Connect, LYME makes it easy.  Simply copy your LYME.CFG
  232. file to TV.CFG, delete all area definitions but TVLIST, change the
  233. .TIC directory to the directory your TVLIST files land in, and
  234. change the !ALLTICS specification to TVLISTTK.ARC.  Then simply add
  235. LYME TV.CFG to your 'event' when Planet Connect's cycle is complete.
  236.  
  237.  
  238.                               -------------
  239.                               IN CONCLUSION
  240.                               -------------
  241.                                     
  242.  
  243.      Lyme is released under the Shareware concept.  If you use
  244. the program and like it, you are strongly encouraged to register
  245. it.  No fee is required to register the program, but donations
  246. are not refused.
  247.      Registrations, along with all comments, questions, and hate
  248. mail may be sent to me via one of the following methods:
  249.  
  250.      Internet:  pab@cnx.com
  251.      Netmail:   Pab Sungenis  1:266/73
  252.      Snail:     1349 Roosevelt Blvd., Vineland, NJ, 08360-6590
  253.  
  254.      We also offer a Fido echomail area called EMPIRE for support
  255. of Lyme, Shut Up And Run The Mail, OLMS Answering Machine, my
  256. GIGO utilities, and EMPIRE Doorware.  For information on
  257. connecting to this area, send netmail.  It's also available as an
  258. Internet mailing list, E-Mail for details.
  259.      Thanks, and enjoy the program.
  260.  
  261.                                              Pab Sungenis
  262.